home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / gui / iedit226.lha / Docs / ScrollerWindow.doc < prev    next >
Text File  |  1996-03-05  |  3KB  |  100 lines
  1. ==========================================================================
  2.   ScrollerWindow.iex  ©1996 Simone Tellini
  3.                                                        All Rights Reserved
  4.  
  5.   This is an external module for Interface Editor
  6.   which is Copyright  ©1994-1996  Simone  Tellini
  7.  
  8.   Based on:
  9.             scrollerwindow.c 0.3 by Christoph Feck
  10. ==========================================================================
  11.  
  12.  
  13. Installation
  14. ------------
  15.  
  16. Just copy the files "ScrollerWindow.iex" and "ScrollerWindow.desc" in  the
  17. "Expanders" subdirectory of InterfaceEditor program's dir.
  18.  
  19. You could need to change a couple of lines in "ScrollerWindow.desc" if you
  20. don't use the DICE compiler.
  21.  
  22.  
  23. Purpose
  24. -------
  25.  
  26. ScrollerWindow.iex lets you make a powerful  and  very  adaptive  scroller
  27. window:  i.e.  a window in which you should show and scroll a bitmap, like
  28. Multiview does when viewing a picture on the Workbench.
  29.  
  30.  
  31. How to use
  32. ----------
  33.  
  34. Open IEditor and create a new window.  Then  select  "Gadgets/Add..."  and
  35. choose "SCROLLER WINDOW": you'll see that the window will change its look,
  36. becoming a little ugly... Well, just close the window and reopen it,  then
  37. it  will  look better... ;-) It's not my fault, but border gadgets need to
  38. be attached to the window before opening it...  Anyway, it's just a matter
  39. of look.
  40.  
  41. This IEX will automagically set some window flags and IDCMP that  it  need
  42. to work properly.
  43.  
  44. Up to now, it supports only window with  menus:  you  can't  add  gadgets,
  45. images, bevel box... etc...
  46.  
  47. ...actually, you could modify a bit the expander to implement some missing
  48. parts... ;-)
  49.  
  50.  
  51. In your application, you can open a scroller window just like every  other
  52. window, but *before* opening it, you MUST perform some actions:
  53.  
  54. 1. You must put a valid bitmap pointer in the <Window Label>BitMap
  55.    variable. This will be the bitmap to show in the window.
  56.  
  57. 2. You must set the variables called <Window Label>HTotal, <>VTotal
  58.    with the size of the bitmap.
  59.  
  60. 3. You must set the variables called <Window Label>VVisible, <>HVisible
  61.    with the right values.
  62.  
  63. See the source "ScrollerWindow.c" for a real-life example.
  64.  
  65.  
  66. The scrolling of the bitmap it's  completely  done  by  the  code  of  the
  67. expander.
  68.  
  69.  
  70. Disclaimer
  71. ----------
  72.  
  73. This is provided "AS  IS",  without  any  warranty  of  any  kind,  either
  74. expressed  or  implied. You use it at your own risk. I won't be liable for
  75. any damage arising out of the use or misuse of this software.
  76.  
  77.  
  78. Credits
  79. -------
  80.  
  81.   Christoph Feck  -  ScrollerWindow.iex derives from his ScrollerWindow.c
  82.  
  83.  
  84. Author
  85. ------
  86.  
  87. Comments, suggestions, etc... to:
  88.  
  89. Snail Mail:
  90.     Simone Tellini
  91.     Piazza Resistenza 2
  92.     42016 Guastalla RE
  93.     ITALY
  94.  
  95. Fidonet:
  96.     2:332/502  (Simone Tellini)
  97.  
  98. Internet:
  99.     Simone.Tellini@f502.n332.z2.fidonet.org
  100.